home *** CD-ROM | disk | FTP | other *** search
/ Apple Service Source 1997 December / Service Source v2.5 Companion 1.iso / Macintosh / System / Java / MRJ 1.5 Info < prev    next >
Encoding:
Text File  |  1997-08-05  |  16.1 KB  |  381 lines  |  [TEXT/ttxt]
  1. Name:         Mac OS Runtime for Java
  2. Version:      1.5
  3. Released:     August 5, 1997
  4. Requires:
  5. A 68030, 68040 or PowerPC microprocessor. System 7.5 or
  6. later, a minimum of 8 MB of RAM (16 MB strongly recommended)
  7. and at least 7 MB of free disk space. Computers with 68030
  8. or 68040 microprocessors must have 32-bit addressing turned
  9. on. Apple Applet Viewer requires OpenDoc 1.0.4 or later.
  10. Using Java applets over the Internet requires MacTCP 2.0.4
  11. or later, or OpenTransport 1.1 or later with TCP/IP, and an
  12. active Internet connection. MRJ 1.5 works with Cyberdog
  13. 1.2.1 or later.
  14. Description:
  15. Mac OS Runtime for Java (MRJ) is Apple's implementation of
  16. the Java runtime environment based on software from Sun
  17. Microsystems, Inc. Mac OS applications adapted to use MRJ
  18. can run Java applets and applications. MRJ 1.5 implements
  19. version 1.0.2 of Sun's Java. MRJ 1.5 includes Apple Applet
  20. Runner, a standalone application that runs Java applets, and
  21. Apple Applet Viewer, an OpenDoc viewer you use to put Java
  22. applets into OpenDoc documents.
  23.  
  24. This software consists of a Disk Copy NDIF (New Disk Image
  25. Format) compressed image, which requires Disk Copy 6.1 or
  26. later to use. Download this software to your hard drive and
  27. then double-click it to use it. Disk Copy is available in
  28. the Utilities folder.
  29.  
  30. Disk Copy 6.1 (or later) or Disk Image Mounter 2.1 (or
  31. later) from Apple are the recommended applications to access
  32. all disk images released by Apple and are the only supported
  33. applications to access NDIF disk images.
  34.  
  35. From the Read Me included with this software:
  36.  
  37. MRJ 1.5 is a major upgrade to MRJ 1.0.2 that significantly
  38. improves Java's graphic performance on the Mac OS. It also
  39. includes Apple's Just-In-Time compiler (JITC) that provides
  40. further, dramatic speed improvement on PowerPC
  41. microprocessors. A JITC for 68030 and 68040 machines is
  42. being developed, but is not yet available.
  43.  
  44. IMPORTANT The Applets menu in Apple Applet Runner includes a
  45. set of applets provided by Sun Microsystems, Inc. These
  46. applets were not created by Apple Computer, Inc. and may not
  47. follow Apple guidelines for user interaction. For example,
  48. buttons in an applet may have different behavior from
  49. buttons in applications developed specifically for the Mac
  50. OS.
  51.  
  52. What's Installed with MRJ?
  53. The MRJ 1.5 installer places the required software
  54. components in your System Folder. If necessary, the
  55. installer will force you to restart your computer before
  56. using MRJ.
  57.  
  58. WARNING: If you have been using a pre-release version of
  59. MRJ, you need to remove files installed with the pre-release
  60. version before installing version 1.5. Use the list below to
  61. check the files you need to remove. However, do not remove
  62. the file named "Text Encoding Converter" or the folder named
  63. "Text Encodings." 
  64.  
  65. On all computers, MRJ 1.5 installs:
  66. * Mac OS Runtime for Java folder in the Apple Extras folder
  67. at the root of the startup disk
  68. * MRJ Libraries folder in the Extensions folder of the
  69. active System Folder
  70. * Text Encoding Converter in the Extensions folder of the
  71. active System Folder
  72. * Text Encodings folder in the active System Folder
  73.  
  74. If you have a 68030 or 68040 computer, MRJ 1.5 also
  75. installs:
  76. * CFM-68K Runtime Enabler in the Extensions folder of the
  77. active System Folder
  78.  
  79. If you have OpenDoc installed, MRJ 1.5 also installs:
  80. * Apple Applet Viewer Libraries folder in the Editors folder
  81. of the active System Folder
  82.    - this folder contains the Apple Applet Viewer
  83. * Apple Applet Viewer Stationery in the Stationery folder at
  84. the root of the startup disk
  85.  
  86. Using the Apple Applet Runner produces a preferences file
  87. named "Apple Applet Runner Prefs" in the Preferences folder
  88. of the active System Folder.
  89.  
  90. Description of MRJ Components
  91. MRJ 1.5 contains the system components necessary to use
  92. Java. It also includes two demonstration tools that use
  93. these components to run Java applets.
  94.  
  95. System Components
  96. The MRJ 1.5 installer puts a folder named "MRJ Libraries" in
  97. the Extensions folder of the active System Folder. The MRJ
  98. Libraries folder contains the MRJLib file, the MRJClasses
  99. folder and, on PowerPC computers, the MRJ JITC files.
  100.  
  101. Apple Applet Runner
  102. The MRJ 1.5 installer installs a folder called "Apple Applet
  103. Runner" which contains the Apple Applet Runner application.
  104. You can find the Apple Applet Runner folder inside the Mac
  105. OS Runtime for Java folder in the Apple Extras folder at the
  106. root of your startup disk.
  107.  
  108. You use Apple Applet Runner to run Java applets from your
  109. local disk. If you have MacTCP or Open Transport installed
  110. and an active Internet connection, you can also run Java
  111. applets over the Internet. 
  112.  
  113. You can run Java applets from your local disk by opening
  114. URLs or local HTML files containing <applet> tags from the
  115. Applet Runner's File menu. In addition, you can run Java
  116. applets by dropping HTML files containing <applet> tags onto
  117. the Apple Applet Runner application icon from the Finder.
  118. You will only see the applet itself inside Apple Applet
  119. Runner; if you use a Web browser to open the HTML file, you
  120. may see additional information.
  121.  
  122. Apple Applet Runner remembers URLs of remote ("http://...")
  123. or local ("file:///...") applets. This information is stored
  124. in the Apple Applet Runner Prefs file in the Preferences
  125. folder of the active System Folder. A few sample URLs are
  126. are available by choosing Open URL from the File menu; you
  127. may add more URLs if you desire. You must have an active
  128. Internet connection to use these remote URLs.
  129.  
  130. Demonstration applets are available under the "Applets" menu
  131. in Applet Runner. You may run these demonstration applets
  132. even if you do not have an active Internet connection. These
  133. applets are stored locally in the Applets folder.
  134.  
  135. Apple Applet Runner's Properties Dialog
  136. The Properties dialog specifies network and filesystem
  137. access and also provides a shortcut to setting some
  138. properties that specify network resources. The Properties
  139. dialog can also specify if package access and definition
  140. should be restricted. To access the Properties dialog,
  141. choose "Properties" from the File menu in Apple Applet
  142. Runner.
  143.  
  144. Most users will not need to change the settings. However, if
  145. you have special networking or security needs such as a
  146. firewall inside your company, you may need to change these
  147. settings.
  148.  
  149. Here is a summary of the items in the Properties dialog:
  150. * Network Access: No Network - This setting does not allow
  151. applets to create sockets.  The applet cannot be a server or
  152. a client.
  153. * Network Access: Applet Host - This setting restricts
  154. applets to only creating sockets on the host machine.
  155. * Network Access: Unrestricted - This setting allows applets
  156. to create sockets with no network restrictions.
  157. * Filesystem Access: No Filesystem - This setting does not
  158. allow any applets access to the local filesystem.
  159. * Filesystem Access: Local Applets - This setting allows
  160. only local applets to have access to the local filesystem.
  161. * Filesystem Access: Unrestricted - This setting allows any
  162. applet access to the local filesystem.
  163. * Restrict Package Access - When checked, this setting
  164. prevents applets from accessing native method interfaces.
  165. For example, it would not be able to access sun.*,
  166. com.apple.*, etc.
  167. * Restrict Package Definition - When checked, it prevents
  168. applets from making classes or loading classes that might
  169. have access to the filesystem.
  170. * HTTP Proxy - When checked, the HTTP proxy specified in the
  171. corresponding fields (server name/number, port number) will
  172. be used when making requests to an HTTP server.
  173. * FTP Proxy - When checked, the FTP proxy specified in the
  174. corresponding fields (server name/number, port number) will
  175. be used when using an FTP server.
  176. * Firewall -  When checked, the firewall specified in the
  177. corresponding fields (server name/number, port number) will
  178. be used in some security checks.  If the the HTTP proxy was
  179. unable to resolve a request then it will use the Firewall
  180. proxy.
  181. * Factory Defaults - Clicking on the Factory Defaults button
  182. will reset to the default settings.
  183. * Cancel - Clicking on the Cancel button will ignore any of
  184. the changes made and close the Applet Properties dialog.
  185. * Save - Clicking on the Save button will save the current
  186. settings and close the Applet Properties dialog.
  187.  
  188. Apple Applet Viewer (for OpenDoc)
  189. You use Apple Applet Viewer to place Java applets into your
  190. OpenDoc documents.
  191.  
  192. A folder called "Apple Applet Viewer" is installed in your
  193. Editors folder and the Apple Applet Viewer Stationery file
  194. is installed in your Stationery folder. Refer to your
  195. OpenDoc documentation for instructions on using stationery.
  196.  
  197. You use Java applets by dragging one of the following to the
  198. Apple Applet Viewer frame:
  199. 1. An HTML file that contains an <applet> tag, 
  200. 2. A text file that contains a URL for an HTML document
  201. containing an <applet> tag, or
  202. 3. A Scrapbook clipping that contains either a URL for an
  203. HTML document containing an <applet> tag or an <applet> tag.
  204.  
  205. Note: You must have an active Internet connection to use
  206. applets at remote URLs.
  207.  
  208. Tips for Using MRJ
  209.  
  210. Mac OS 8
  211. Mac OS 8 includes MRJ 1.0.2 which is pre-set to install as a
  212. standard component of Mac OS 8. If you have already
  213. installed MRJ 1.5 and you are installing Mac OS 8, you
  214. should de-select MRJ in the installer list of components
  215. being installed. If you don't de-select the MRJ install you
  216. will get an error message when MRJ 1.0.2 tries to install
  217. over MRJ 1.5. If you get to this point you should press the
  218. Skip button which will allow you to skip, or bypass, the MRJ
  219. 1.0.2 installation and continue with the rest of the Mac OS
  220. 8 installation.
  221.  
  222. OpenDoc
  223. If you do not have OpenDoc installed when you install MRJ
  224. 1.5, the Apple Applet Viewer will not be installed. If you
  225. install OpenDoc later, you must reinstall MRJ to use the
  226. Applet Viewer.
  227.  
  228. Memory Usage
  229. MRJ uses system memory to run Java applets and applications.
  230. Applications allocate their own application memory, leaving
  231. less memory available to the system. If an application that
  232. uses MRJ (such as the Applet Runner or Cyberdog) is using an
  233. especially large amount of memory, you may have trouble
  234. running large Java applets or applications. If you encounter
  235. problems, try quitting applications you aren't using. If you
  236. still cannot run the applet or application, try reducing the
  237. amount of memory used by the application that is using MRJ.
  238. To reduce an application's memory size, first quit the
  239. application, then select the application's icon and choose
  240. Get Info from the File menu. Type a smaller number in the
  241. Preferred Size field. (However, do not set the preferred
  242. size smaller than the indicated minimum size).
  243.  
  244. Adding to the Classpath
  245. For some applets, you may need access to classes that are
  246. not in the same directory as the applet tag. To allow
  247. additional Java classes or zip files to be referenced by MRJ
  248. when running an applet, do one of the following:
  249.  
  250. - In the html document, add a codebase parameter to the
  251. applet tag. This technique can be used when the classes are
  252. either on your disk or on the Internet. Add a parameter of
  253. the form "codebase=file:///mydisk/myfolder/myzip.zip" (for
  254. classes on your disk) or
  255. "codebase=http://hostname/dirname/theirzip.zip" (for classes
  256. on the Internet) to the applet tag that is in the .html file
  257. you open with Apple Applet Runner or Apple Applet Viewer.
  258. See general Java and html references for more details on the
  259. applet tag format and the codebase parameter.
  260.  
  261. - Add an alias to the MRJClasses folder. This technique is
  262. useful when you have a local copy of a .zip file, or a
  263. folder with a collection of Java classes, on your disk. If
  264. the item you wish to add is a .zip file or a folder
  265. containing .class files, you can add the aliases directly.
  266. Put an alias to the item (.zip file or folder) into the MRJ
  267. Classes folder in the Extensions folder in the active System
  268. Folder. To add a single class file to the classpath, make an
  269. alias to the folder containing the class file and put that
  270. alias into the MRJ Classes folder.
  271.  
  272. Note: Currently, any MRJ runners or viewers that are open
  273. will have to be quit and relaunched for the new classes to
  274. be recognized.
  275.  
  276. Known Problems
  277. * You must restart your computer after installing MRJ. If
  278. you attempt to run MRJ without restarting, MRJ may behave in
  279. unexpected ways.
  280.  
  281. * Do not remove the Text Encodings folder from the System
  282. Folder or the Text Encoder Converter file from the
  283. Extensions folder. Removing these items may cause problems
  284. while using MRJ or using other applications requiring these
  285. files.
  286.  
  287. * In pre-release versions of MRJ, the preferences file was
  288. named "Applet Runner Prefs." If you had a pre-release
  289. version of MRJ installed, make sure you throw the "Applet
  290. Runner Prefs" file away. (The old file may conflict with
  291. preference files created by applet runner applications from
  292. other companies.)
  293.  
  294. * There is a known problem with the PPCExceptionEnabler
  295. extension. This extension is installed by Macintosh Common
  296. Lisp (MCL) 3.9. If you have this extension, you must remove
  297. it before running MRJ. Future versions of MCL will not
  298. require this extension.
  299.  
  300. * If you're using Microsoft Internet Explorer, you should
  301. use version 3.01 or later.
  302.  
  303. * If you are running applications or applets compiled with
  304. the JavaSoft 1.0.2 JDK release for Macintosh, you may
  305. encounter numerics-related problems. Specifically,
  306. floating-point constants (and in some cases computed integer
  307. constants) may not be accurate. If possible, use another
  308. Java compiler to recompile any applications or applets
  309. displaying this problem.
  310.  
  311. * If all the images and sounds an applet uses don't appear,
  312. there may not be enough memory available for all the images
  313. and sounds. You may be able to free up memory by quitting
  314. all applications (such as the Apple Applet Runner and Apple
  315. Applet Viewer) that use MRJ. If necessary, try quitting
  316. other applications as well. After quitting the applications,
  317. try reopening Apple Applet Runner or Apple Applet Viewer.
  318. See Memory Usage above for additional information.
  319.  
  320. * Some Java applets (such as Clock) or applications that are
  321. processor intensive may cause other applets to open or run
  322. slowly, or may cause them not to open at all. To improve
  323. performance, try closing applets or applications that you
  324. are not using.
  325.  
  326. * The Apple Applet Viewer does not report some errors. If an
  327. applet does not open in Apple Applet Viewer, try opening it
  328. with Apple Applet Runner to see if an error message appears.
  329.  
  330. Further Information and Reporting Problems
  331. See our Web site at <http://applejava.apple.com/> to find
  332. out about future releases of Mac OS Runtime for Java or get
  333. information on how to report problems with the software.
  334.  
  335. Other Applets on the Internet
  336. There are thousands of applets available on the Internet.
  337. Two good starting points for finding applets are:
  338. * <http://www.javasoft.com/>
  339. * <http://www.gamelan.com/>
  340.  
  341. Software Development Kit Available
  342. A software development kit (SDK) is available for MRJ 1.5.
  343. The MRJ SDK includes interfaces to the runtime environment
  344. that allow software developers to:
  345.  
  346. * run Java applets and applications within a Macintosh
  347.   application
  348. * access the Java runtime from a Macintosh application
  349. * call Java methods from C and C++
  350. * call native methods from Java
  351. * build standalone Java applications
  352.  
  353. The SDK also includes a utility to run Java applications.
  354.  
  355. See our Web site at <http://applejava.apple.com/> to get the
  356. MRJ SDK.
  357.  
  358. Java not Fault-tolerant
  359. The Java technology is not fault-tolerant and is not
  360. designed, manufactured or intended for use or resale as
  361. on-line control equipment in the operation of nuclear
  362. facilities, aircraft navigation or communication systems, or
  363. air traffic control machines in which the failure of the
  364. Java technology or Mac OS Runtime for Java could lead
  365. directly to death, personal injury, or severe physical or
  366. environmental damage.
  367.  
  368. (c) 1995-1997 Apple Computer. Inc. All rights reserved. 
  369. Apple, the Apple logo, MacTCP and Mac are trademarks of
  370. Apple Computer, Inc., registered in the U.S. and other
  371. countries. PowerPC is a trademark of International Business
  372. Machines Corporation, used under license therefrom. Java and
  373. all Java-based trademarks and logos are trademarks or
  374. registered trademarks of Sun Microsystems, Inc. in the U.S.
  375. and other countries. All other product names are trademarks
  376. or registered trademarks of their respective holders.
  377. Mention of non-Apple products is for information purposes
  378. and constitutes neither an endorsement nor a recommendation.
  379. Apple assumes no responsibility with regard to the
  380. selection, performance, or use of these products.
  381.